home *** CD-ROM | disk | FTP | other *** search
- Welcome to the crash course on learning how to use PC Editor.
-
- This editor is written for quick and dirty edit jobs. It's
-
- small in size so it will not take much needed space away from
-
- the system. Also its size allows the DOS to load and execute it
-
- faster. First topic to learn is the function keys. Only the
-
- first five are define and they are as follows:
-
- F1 - Page forward 20 lines (PgDn also works the same).
- F2 - Page backward 20 lines (PgUp also works the same).
- F3 - Page down 1 line at a time.
- F4 - Insert lines. Must Press This Key Before Adding New Lines.
- F5 - Redisplays page. Used usually after inserting lines (F4).
-
- (Time to either press F1 for the next page or F3 for the next line)
-
-
- Now since you got a feel for paging in the editor, it is time to learn
-
- more about the editor's abilities. This is a command driven editor
-
- with very simple and few commands to remember. Most of them are quite
-
- common and can be easily related to other PC programs such as MS-BASIC.
-
- All commands are keyed and entered on the top line. This will be refered
-
- to as the "command line" from now on. Any command can be entered on
-
- this line at any time. After the command is executed, a reply to the
-
- execution is displayed on the second line. This will be refered to as
-
- the "reply line" from now on. Most of the editor's commands are not
-
- needed by everyone but are still there just in case. For the size of
-
- the editor, you might be suprised by the preformance and power.
-
-
- How to LOAD a File into the Editor:
-
- The editor accourse has a command to do this and probably is the most
-
- common used command. All you have to do is type on the command line
-
- the word "LOAD" followed by a file name. The first page of the file
-
- will be display after it is loaded. After editing a file, you must
-
- save the changes to the disk drive.
-
- How to SAVE a File from the Editor:
-
- The Editor won't ever save a file for you. After making the
-
- changes needed, you must type on the command line the word
-
- "SAVE" followed by a file name or an asterisk (*). The asterisk
-
- will tell the editor to save the file under the last file name
-
- used which is displayed at the bottom of this screen in the center.
-
- But what if someday a new file needs to be created? Read on.
-
-
- How to CREATE a File on the Editor:
-
- To create a new file, just type on the command line the word "CREATE"
-
- followed by a filename. The editor will clear the present file
-
- and put you in the insert (F4) mode with the cursor in the text
-
- area. This does not create a file on any device. You must be
-
- sure to use the SAVE command to have it written to the disk.
-
-
- How to list the FILES on a disk drive:
-
- All you must do is type "FILES" on the command line and press enter.
-
- The screen will clear and a list of files for the default drive will
-
- be displayed. If you would like to see the filenames of a drive other
-
- than the present default drive, type the drive letter followed by a
-
- colon after the command "FILES". To get back to the edit file, enter
-
- the command "LIST".
-
-
- How to get OFF the Editor:
-
- After you are finished editing a file, this command will take you
-
- back to DOS. Be sure though you understand that this command does
-
- not save any files. If changes are made to a file and the changes
-
- are to be save, be sure to use the "SAVE" command first. Also, there
-
- are not any backup file created by this editor.
-
-
-
-
-
-
-
-
-
- If you find this program of use, please send $20.00 to:
-
- Douglas McLean
- P.O. Box 94064
- B'ham, Al 35220
-
- This entitles you to a current version of the Editor
- and your name will be added to a list for future updates.
- Please send along any suggestions for future additions to
- the Editor.
-
- Please pay by either check or money order. Make checks
- payable to Douglas McLean. Also be sure to include your
- name and address with zip code for future references.
- Allow 2 to 3 weeks for delivery of the latest version
- diskette.
-
- This program is being distributed under the guidelines of
- Freeware. The price only covers the cost and the trouble
- of producing this product. Future update versions will
- have a small additional charge of $5.00 a diskette.
-
-
- PC EDITOR Page 1 of 15
-
- Quick Reference
-
- CAPS (#1),#2
- Changes all alphabetic letters to upper case.
-
- CHANGE |*string1*string2*| (line1),line2
- Replaces all occurances of string1 with string2.
-
- CHDIR (PATH)
- Changes directory.
-
- CLEAR (none)
- Clears the screen.
-
- CLS (none)
- Clears the screen.
-
- COLOR |#1|,#2,#3,#4
- Changes colors for the screen.
-
- CREATE |(d:)(path/)(filename.ext)| or |*|
- Clears memory for a new file to be entered.
-
- CURSOR (none)
- Changes cursor size.
-
- DELETE |(#6),(#2)|
- Deletes a group of lines
-
- DOS (command) (filename)
- Allows for DOS command to be entered.
-
- DRIVE (A),B,C ... etc
- Changes or displays default drive.
-
- DUPLICATE |#1,#2,#3|
- Repeats a group of lines
-
- EXECUTE |(d:)(path)(filename.ext)|
- Executes the program listed.
-
- FILES (none)
- Directory of the default drive.
-
- FIND |*string*|
- Displays first occurance of string.
-
-
-
-
- -- 1. --
-
-
-
-
-
- PC EDITOR Page 2 of 15
-
-
- KILL |(d:)(path/)(filename.ext)| or |*|
- DELETES the FILE specified from a disk drive.
-
- LIST (#)
- List file with line specified. Default is 1.
-
- LOAD |(d:)(path/)(filename.ext)| or |*|
- Loads a file specified from a disk drive.
-
- MERGE |(d:)(path/)(filename.ext)| or |*|
- Merges a file from disk to the end of a file in memory.
-
- MKDIR |path|
- Makes a sub-directory.
-
- MOVE |#1,#2,#3|
- Moves a group of lines in the file in memory to a new location.
-
- OFF (none)
- Returns to system program.
-
- PRINT (#1),#2
- Prints the file in memory or the lines specfied.
-
- RMDIR |path|
- Deletes a sub-directory.
-
- SAVE |(d:)(path/)(filename.ext)| or |*|
- Saves a file specified to disk.
-
- SPLIT |(d:)(path/)(filename.ext)| or |*|
- Splits a file into multiply files.
-
- SUBMIT (none)
- Sends file in memory to RJE.
-
- TABS |#1|,#2,...,#10
- Changes tab key settings.
-
- + (none)
- Displays last command on the command line.
-
- - (none)
- Executes last command entered again.
-
-
-
-
-
- -- 2. --
-
- PC EDITOR Page 3 of 15
-
-
-
-
-
-
-
- DEFINED KEYS
- Key Function
-
- F1 Pages twenty lines forward.
- F2 Pages twenty lines backward.
- F3 Advances one line forward.
- F4 Insert up to ninteen lines.
- F5 Updates present screen.
-
- (All other FUNCTION KEYS are undefined)
-
-
- CTRL-END Erases to the end of the line from
- the current cursor position.
- CTRL-BRK Stops certain processes while executing.
- SHIFT-PrtSc Prints present screen on the printer.
- END Positions the cursor to the last character
- of a line.
- PgUp Pages twenty lines backward. (same as F2)
- PgDn Pages twenty lines forward. (same as F1)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- -- 3. --
-
- PC EDITOR Page 4 of 15
-
-
-
- COMMENTS:
-
- When an asterisk (*) is used in a command, the editor will take the
- default file name and use it. The default file name is displayed on the
- bottom line in the center.
-
-
- When entering a command, only the first three characters of the
- command need to be entered except for commands one character in length.
-
-
- To have a blank line, there must be atleast one character (or a
- space) on that line. The longest line allowed is 253 characters.
-
-
- To erase a line completly from the screen, press CTRL-END keys
- simultaneously. This will erase all the characters on a line from
- the cursor location until the end of the line.
-
-
- This program requires minimum 128k of memory and DOS version 2.0
- to work properly.
-
-
- The percentage displayed on the bottom line is the amount of memory
- left for your file out of the initial 64k work block.
-
-
- The largest file that can be created or edited is 65,535 bytes long.
- To keep the size of the file down, use the standard tabs instead of the
- space bar. If the tab key is redefined by using the TABS command, this
- rule does not apply.
-
-
- The user can create a file called AUTOEXEC.ED that is composed of
- commands for the editor. Everytime the editor is executed it will look
- on the default drive for this file. If it is found, each line will be
- executed as a separated command. When creating this file, each command
- can only be eighty characters in length. If larger, only the first
- eighty columns are used.
-
-
- On certain editor functions the CONTROL BREAK key can be used to
- terminate the process. The functions included are PRINTing, listing the
- FILES, and when the AUTOEXEC.ED is executing.
-
-
- When using the DOS command, the user should be sure to have the same
- COMMAND.COM file version on the default drive that the system is booted
- up under. Not having this will cause serious problems.
-
-
- When specifing a string in such commands as SCAN and EDIT, a
- character can be represented by it's hexidecimal equivalent. For
- example an "*A*" would be "*&H41*". All other unprintable characters can
- be edited this way except the CR and LF at the end of each line.
-
-
- -- 4. --
-
-
-
- PC EDITOR Page 5 of 15
-
-
- When your are trying to LOAD a file larger than 64k into the
- Editor, a message will appear requesting you to use the SPLIT command.
- This will SPLIT a file into segments of 75% of 64k. The file being
- split must reside on a disk drive. The new files will be created on
- the default drive with names ranging from SPLIT.001 to SPLIT.999.
- If SPLIT files already exist, the numbering will continue with the
- next highest numbered extension. To join the files back together,
- use the DOS command COPY.
- Example: DOS COPY SPLIT.001+SPLIT.002 EDIT.DAT
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- -- 5. --
-
-
-
- PC EDITOR Page 6 of 15
-
-
- CAPS (Changes to upper case letters)
- Command
-
- Purpose: Change all of the lower case letters to upper case.
-
- Format: CAPS (#1),#2
-
- Remarks: All letters between a lower case "a" and "z" will be changed
- to it's respective upper case letter. The line numbers are
- optional. If only one line number is supplied, the letters
- from that line on down are changed. But if two line numbers
- are supplied, then the letters within the lines are changed.
-
-
- CHANGE (Edit a string)
- Command
-
- Purpose: Replaces all occurances of the first string to the contents of
- the second string.
-
- Format: CHANGE |*string1*string2*| (line1),line2
-
- Remarks: All occurances of the first string are replaced by the
- contents of the second string. Strings can be in lenght up to
- fifteen characters. The first string must be atleast one
- character, but the second string can have a length of zero.
- Changing starts with the top line on the screen unless a
- starting line with or without an ending line is given after
- the strings.
-
-
- CHDIR (Change Directory)
- Command
-
- Purpose: Change the DOS current directory of the specified or default
- drive.
-
- Format: CHDIR ((d):path)
-
- Remarks: DOS will change the current directory to the directory
- specified, and now will use this directory as the default. If
- a directory is not specified, the path of the default drive is
- displayed.
-
-
- CLEAR (Clears the screen)
- Command
-
- Purpose: Clears the current screen.
-
- Format: CLEAR or CLS
-
- Remarks: When this command is entered, the page location is reset to
- the first page in memory.
-
-
- -- 6. --
-
-
-
- PC EDITOR Page 7 of 15
-
-
- COLOR (Changes the colors for display)
- Command
-
- Purpose: Change the current colors displayed on the color monitor.
-
- Format: COLOR |#1|,#2,#3,#4
-
- Remarks: On the color monitor, the colors can be changed from the
- default by using this command. The first number determines
- the color for the text being edited. The second number
- changes the color for the command line, the reply line, and
- the status line. The third number changes the color for the
- frame around the screen. The fourth number changes the color
- of the column lines. If the fourth number is not specified,
- the second is used as the default.
-
-
- CREATE (Creates a new file)
- Command
-
- Purpose: To clear memory and rename the default file for a new program.
-
- Format: CREATE |(d:)(path/)(filename.ext)|
-
- Remarks: When this command is entered, the previous file in memory is
- erased and can not be retrieved. The cursor is position in
- the insert mode ready for input.
-
-
- CURSOR (Changes the cursor size)
- Command
-
- Purpose: Changes the size of the cursor to a full block.
-
- Format: CURSOR
-
- Remarks: The first time the command is entered the cursor will change
- to a full block. The second time it is entered the cursor
- will return to it's original size.
-
-
- DELETE (Deletes lines)
- Command
-
- Purpose: Deletes a group of lines at one time.
-
- Format: DELETE |#1,#2|
-
- Remarks: To delete a line or a group of lines, enter the first line
- (number) to be deleted followed by the last line (number) to
- be deleted. Only one hundred lines can be deleted at one time.
-
-
-
- -- 7. --
-
-
-
- PC EDITOR Page 8 of 15
-
-
- DOS (Enter DOS commands)
- Command
-
- Purpose: Allows for a DOS command or file to be executed.
-
- Format: DOS (command) (parameter)
-
- Remark: To enter a DOS command, type DOS followed by the command
- desired. By entering just the DOS command alone allows you to
- get into another copy of the command processor. To get back
- to the Editor, type EXIT at the DOS prompt and press enter.
-
-
- DRIVE (Change drive)
- Command
-
- Purpose: Changes the default drive to the one specified.
-
- Format: DRIVE |A|,B,C
-
- Remark: To change the default drive, specify the new drive after the
- command. If a drive is not specified, the reply message
- 'DEFAULT DRIVE IS ?' is returned.
-
-
- DUPLICATE (Duplicate lines)
- Command
-
- Purpose: Duplicate a group of lines to a new location.
-
- Format: DUPLICATE |#1,#2,#3|
-
- Remarks: This command can be used to duplicate a group of lines to a
- new location. The first line (number) specified is the start
- of the group of lines. The second line (number) specified is
- the ending of the group of lines. The third line (number)
- specified is the insert point for the group of lines. Only 20
- lines can be duplicated at one time.
-
-
- EXECUTE (executes a program)
- Command
-
- Purpose: Executes another program from the editor.
-
- Format: EXECUTE |(d:)(path/)(filename.ext)(parameter)|
-
- Remarks: This command will execute another program from within the
- editor. The file must have either an EXE or COM extention.
- After the program has completed execution, the system will
- return to the editor. The file in memory will still be present
- for editing. Possible errors returned are INSUFFICIENT MEMORY,
- FILE NOT FOUND, and ERROR IN EXECUTION.
-
-
- -- 8. --
-
-
-
- PC EDITOR Page 9 of 15
-
-
- FILES (List directory)
- Command
-
- Purpose: Lists the current directory.
-
- Format: FILES (d:)(path/)(filename.ext)
-
- Remarks: The files command gives a listing of the files on the current
- directory, sub-directory, or the one that is specified.
-
-
- FIND (scans the file in memory)
- Command
-
- Purpose: To find the first occurance of a string.
-
- Format: FIND *string1*
-
- Remarks: This command will allow you to find the first occurance of a
- string up to fifteen characters in length. The minus sign (-)
- can be used after this command to find the next occurance.
- When all of the occurances of a string have been found, a
- message will be displayed.
-
-
- KILL (Deletes file)
- Command
-
- Purpose: Deletes the file specified from a disk drive.
-
- Format: KILL |(d:)(path/)(filename.ext)|
-
- Remark: The file specified or the default file will be DELETED from
- the directory of the disk drive.
-
-
- LIST (Displays text)
- Command
-
- Purpose: Display the file loaded on the screen.
-
- Format: LIST (#)
-
- Remarks: The list command displays the beggining page of the text on
- the screen. A line number can be specified and a page beg-
- gining with that line will be displayed. If the line number
- is greater than the actual number of lines, the end of file
- line is displayed. Paging back by using F2 will display the
- last page of the file in memory.
-
-
-
-
- -- 9. --
-
-
-
- PC EDITOR Page 10 of 15
-
-
- LOAD (Loads files)
- Command
-
- Purpose: Loads a file from a drive to be edited.
-
- Format: LOAD |(d:)(path)(filename.ext)|
-
- Remarks: With this command the user can load a standard ASCII file for
- updates. The file can be up to 64k bytes an length. This
- command changes the default file and remembers what drive it
- was read from.
-
-
- MERGE (merges files)
- Command
-
- Purpose: Merges a file from a drive to an existing file in memory.
-
- Format: MERGE |(d:)(path/)(filename.ext)|
-
- Remarks: This command is used to load a file from a disk drive into
- memory after the present file loaded. The default file name
- stays unchanged.
-
-
- MKDIR (Makes directory)
- Command
-
- Purpose: Makes a new sub-directory on the default drive.
-
- Format: MKDIR |(d:)path|
-
- Remarks: In making a new sub-directory specify the ASCII string as
- defined in the DOS manual. A sub-directory will be made on
- the default drive in the current directory.
-
-
- MOVE (transfer lines)
- Command
-
- Purpose: To move a group of lines from one location in the file to a
- new location.
-
- Format: MOVE |#1,#2,#3|
-
- Remarks: The first line (number) specified is the starting location of
- a line or a group of lines. The second line (number)
- specified is the ending location of that group of lines to be
- moved. The third line (number) specified is the insert point
- for the group of lines.
-
-
-
-
- -- 10. --
-
-
-
- PC EDITOR Page 11 of 15
-
-
- OFF (Exit program)
- Command
-
- Purpose: The OFF command returns the user back to DOS.
-
- Format: OFF
-
- Remarks: You will be returned to the DOS operating system. If a color
- monitor is being used, the frame color will remain the same.
-
-
- PRINT (Prints the file on memory)
- Command
-
- Purpose: This command is used for a listing of the file in memory on
- the printer.
-
- Format: PRINT (#1),#2
-
- Remarks: If you wants to print the whole listing, the "PRINT" command
- without any line numbers can be used. To print only a portion
- of the file, line numbers can be specified. The file will be
- printed from the first line listed until the last line listed.
- If the second line is not listed, the file is printed from the
- first line number until the end of the file.
-
-
- RMDIR (Removes a directory)
- Command
-
- Purpose: Removes a sub-directory from the specified or default drive.
-
- Format: RMDIR |(d:)path|
-
- Remarks: In removing a sub-directory specify the ASCII string as
- defined in the DOS manual. In order to delete a sub-
- directory, the directory must already be empty.
-
-
- SAVE (saves a file from memory)
- Command
-
- Purpose: To save the present file being edited to a disk file.
-
- Format: SAVE |(d:)(path/)(filename.ext)|
-
- Remarks: With this command you can save a file in a standard ASCII form
- The file saved can be up to 64k bytes in length. The default
- file name will be changed.
-
-
-
- -- 11. --
-
-
-
- PC EDITOR Page 12 of 15
-
-
- SPLIT (splits a file into multiply files)
- Command
-
- Purpose: To split a file to large for editing into smaller files.
-
- Format: SPLIT |(d:)(path/)(filename.ext)|
-
- Remarks: The SPLIT command is used when a file is to large to fit into
- memory (over 64k). The amount of files created will be
- determined by the size of the input file. Each file created
- will have a maximum length of 75% of 64K, allowing enough room
- for editing. The filenames for the split file will be
- SPLIT.001 to SPLIT.nnn. The numbering will start after the
- highest numbered extension. This command allows a user to get
- around the limitation of only being able to edit a 64k length
- file. To join the SPLIT files back together again, use the
- DOS command COPY.
-
-
- SUBMIT (send a program to the main computer)
- Command
-
- Purpose: To send a file out the async port.
-
- Format: SUBMIT
-
- Remarks: The file must be already loaded into memory of the editor.
- When this command is entered, the file will be sent through
- the asynchronous adapter at the default baud rate of the
- editor or a baud rate set by using the DOS MODE command.
- There is no way of breaking in the middle of sending a file
- and there is not any Hand Shaking between devices.
- (Enter on the command line to set the default Baud Rate.)
- DOS MODE COMn:baud,parity,databits,stopbits
-
-
-
- TABS (set tabs)
- Command
-
- Purpose: To set the tab columns for the tab key.
-
- Format: TABS |#1|,#2,...,#10
-
- Remarks: The tab key can be changed from the default values to a new
- set of values. You can define up to ten tab settings for a
- row on the screen.
-
-
- + (plus)
- Command
-
- Purpose: Displays previous command.
-
- Format: +
-
- Remarks: This command displays the command previously entered. The
- command is only displayed, not executed.
-
-
- -- 12. --
-
-
-
- PC EDITOR Page 13 of 15
-
-
- - (minus)
- Command
-
- Purpose: Executes previous command.
-
- Format: -
-
- Remarks: This command executes the previous command entered. When
- using commands such as SCAN, the minus command is helpful.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- -- 13. --
-
-
-
- PC EDITOR Page 14 of 15
-
-
- RETURN MESSAGES
- What do such messages mean.
-
- MESSAGES REASON
-
- ACCESS DENIED The path can not be accessed.
-
- DEFAULT DRIVE IS |A| Gives the present default drive.
-
- DIRECTORY OF DRIVE |A| The directory of the default drive
- was given.
-
- ENTER COMMAND The editor is waiting for a
- command to be entered.
-
- ERROR IN EXECUTION While execution of another program,
- an error occured.
-
- FILE NOT FOUND The file specified was not located
- on the drive searched.
-
- FILE TO LARGE TO LOAD - The file specified on a load is
- USE THE SPLIT COMMAND larger than 64k.
-
- FILE TO LARGE TO MERGE - The file specified on a merge is
- USE DOS COPY COMMAND too large to fit in the remaining
- portion of unused memory.
-
- IMPROPER LINE NUMBER The line for that number does not
- exist in the text.
-
- INSUFFICIENT DISK SPACE Not enough space on the disk drive.
-
- INSUFFICIENT MEMORY The memory left in the text area
- was not enough for the function
- being performed.
-
- INVALID COMMAND NAME The command name given is not
- recognized.
-
- INVALID DRIVE SPECIFIED Drive given is an invalid drive for
- the system.
-
- INVALID FILE SPECIFIED The file name given is incorrect
- according to the DOS standards.
-
- INVALID HEX NUMBER The hexidecimal number given is
- invalid.
-
- INVALID LINE NUMBER Line number is not numeric.
-
- INVALID LINE SPECIFIED The sequence of the line numbers
- is invalid.
-
- INVALID STRING The string delimiters are not found.
-
-
-
-
- -- 14. --
-
-
-
- PC EDITOR Page 15 of 15
-
-
- INVALID STRING LENGTH Too many characters in the string
- specified.
-
- NO FILE SPECIFIED The file name is not present in
- a command.
-
- NO COLOR MONITOR The PC being used does not have
- a color monitor connected.
-
- PATH NOT FOUND The directory specified was not
- located.
-
- PRINTER IS NOT READY Printer is either turn off or off
- line.
-
- PROCESS COMPLETED The command entered ended normally.
-
- PROCESS TERMINATED The command executing has ended
- abnormally. The problem should be
- noticable.
-
- SENDING THE FILE The file loaded into memory is
- being sent through the communication
- port.
-
- STRING FOUND The string being searched for was
- found.
-
- STRING NOT FOUND The string being searched for was
- not found in the remainder of the
- file.
-
- TOO MANY LINES Trying to use a group of lines
- larger than what the command will
- accept.
-
-
-
-
-
-
-
-
-
- -- 15. --
-